The dataSet element is the parent element for a collection of item elements, which are processed sequentially and used to assign a value to the parent data group element. The dataSet element and its item children are required as components in one of several reference operation structures. For example, a dataSet is required if the opMax operation is used. The data set can define the total number of values from which only one must be returned to the parent data group element, or the data set can define a subset of values that are compared to other values outside of that data set.
This element is:
To learn about how this element relates to other elements in a CygNet device template file, see Template File Hierarchy.
See also Reference Methods – Arithmetic Examples.
Example
 Click here to see an example of reference operations
<MaxValDEID desc="Maximum value of data group element" readOnly="true" type="ui2" isRef="1"> <ref prec="0" refOp="opAssignId" deid="raw2"/> <ref prec="1" refOp="opScaleFactor" scaleFactor="10"/> <ref prec="2" refOp="opMax"> <dataSet> <item value="50"/> <item deid="raw1"/> <item deid="raw10"/> </dataSet> </ref> </MaxValDEID> |
The following table lists and describes special child elements used within a dataSet element.
| Attribute | Description |
|---|---|
|
item |
item defines a value as one in a list or data set that can be acted upon by a parent refOp value. item values can derive from a constant (value) or from a variable (deid). At least one item element must be in the dataSet element. item values must be numeric. |
The following table lists and describes attributes generally applicable to this element. However, not all of the attributes listed here are applicable to all EIEs. Additionally, some attributes are required for use in every device template file of a certain EIE, but others may be used on a case-by-case or device-by-device basis, depending on your specific needs. All attributes in templates are case sensitive; but the case sensitivity of attribute values is based on context.
Note: Occasionally, device template files for different EIEs use attributes of the same name that do different things. Efforts are made in this document to highlight cases where an attribute by one name does different things in different EIEs.
| Attribute | Description |
|---|---|
|
deid |
deid specifies the data group ID (DEID) of a referenced DataGroupElement element from which to use a value. Value:
|
|
value |
value specifies a constant value. The value used must be relevant to the context in which value is used. Value:
|
|
|
|
